home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Reference Guide / C-C++ Interactive Reference Guide.iso / c_ref / csource4 / 249_01 / readme.dat < prev    next >
Text File  |  1987-10-29  |  11KB  |  197 lines
  1.  
  2.  
  3.                                  C Spot Run
  4.  
  5.                       A User-Supported C Add-On Library
  6.  
  7.                          Version 2.1  "ReadMe" File
  8.  
  9.                                 July 12, 1987
  10.  
  11.  
  12.           Hello,  and  welcome to the C Spot Run  package.   This  file 
  13.       contains  the information that for one reason or  another  wasn't 
  14.       placed in the newsletter or documentation.
  15.  
  16.           Following is a list of the files in this archive and a  short 
  17.       description of each.
  18.  
  19.               CCDEMOMS.BAT     Batch to compile CSRDEMO for Microsoft.
  20.               CCDEMOTC.BAT     Batch to compile CSRDEMO for Turbo C.
  21.               CHECKC.EXE       Executable for the CheckC program.
  22.               COLOR.H          Include file with color definitions.
  23.               CSR201.NWS       Volume 2 - Number 1 of the Newsletter.
  24.               CSRDEMO.C        Demo program for C Spot Run.
  25.               CSRDEMO.EXE      Executable of CSRDEMO.C.
  26.               CSRDEMO.PRJ      Project file to make CSRDEMO in Turbo C.
  27.               CSRDOS.H         Include file for directory searching.
  28.               CSRMENU.H        Include file for menu routines.
  29.               CSRMISC.H        Assorted #definitions for CSR.
  30.               CSRMODES.H       Include file with set_mode() options.
  31.               CSRMSC.LIB       Linkable  version  of  the  library  for 
  32.                                Microsoft C.
  33.               CSRSHELL.ASM     Shell for assembly interface to C.
  34.               CSRSOUND.H       Some note values and declarations.
  35.               CSRTIME.H        Text arrays for week and names.
  36.               ERRORS.H         Text of critical DOS errors.
  37.               FLINE.EXE        Executable for the FirstLine program.
  38.               README.C         The source code to the README program.
  39.               README.DAT       The file you are reading now.
  40.               README.EXE       The executable version of README.
  41.               SKEY.H           Special extended key definitions.
  42.               TIMERS.C         Source code to timer functions.
  43.               TSCSR.LIB        Linkable  version  of  the  library  for 
  44.                                Turbo C.
  45.  
  46.           +>  CSRWHOLE.DOC     Complete C Spot Run documentation.
  47.           +>  CSRUPDT.DOC      Just differences from 2.0 documentation.
  48.           |
  49.           +------------------  Only one of these  files is  present  in 
  50.                                this  archive, depending on if  this  is 
  51.                                CSR21.ARC or CSRUPDT2.ARC.
  52.  
  53.  
  54.       What's Up.
  55.  
  56.           A  lot  is up.  CSR is here, bigger and better, and I  am  so 
  57.       tired  I'm  about to fall asleep for a week.  (CSR is  only  here 
  58.       because of a two week writing spree, code and text.)
  59.           As  some of you know, a new version of CSR has been  due  for 
  60.       some time, and promised for as long.  In order to finally release 
  61.       it I had to make a few compromises.  (Sort of.)  The  compromises 
  62.       are  pretty  much trivial, but include the following:   (This  is 
  63.       also the 'future enhancements' list:) The communications routines 
  64.       couldn't  be debugged in time.  Look forward to interrupt  driven 
  65.       communications complete with a couple of file transfer protocols, 
  66.       but not in this version.  ....  I'd really like to totally  clean 
  67.       up  the documentation, but while some small changes were made  it 
  68.       hsn't  been done yet.  The routines need better descriptions  and 
  69.       much better examples.  ....  The source itself should be  cleaned 
  70.       up,  with  declarations available for use with  #LINT_ARGS,  etc.  
  71.       Some  optimization  wouldn't  hurt.   ....  I'd  like  to  add  a 
  72.       completely  new set of windowing routines, virtual  windows  that 
  73.       can  be bigger than their actual size, or even the screen.   ....  
  74.       A  really good issue of the newsletter is high on my  wish  list, 
  75.       and  I'm  looking forward to some writing contributions  by  some 
  76.       users.  (Two have already volunteered.)
  77.           You  can  look forward to some of those things  in  the  next 
  78.       version  of CSR.  (This version, while very much an  improvement, 
  79.       is  mainly  to fill some gaps left by 2.0, and  to  provide  some 
  80.       support for Turbo C, etc.)
  81.           Now  that  you've heard what isn't here I  suggest  that  you 
  82.       check out the newsletter for a description of what is.
  83.  
  84.  
  85.       Wading Through the Documenation.
  86.  
  87.           One  of  the first things your are going to want  to  do,  or 
  88.       rather should do, is print out the documentation to C Spot Run.
  89.           For  practice  (smile)  you can  print  out  the  newsletter.  
  90.       You'll  need  either a file dumping utility that doesn't  do  ANY 
  91.       formatting, or simply type COPY CSR201.NWS PRN at a DOS prompt.
  92.           If  you already printed out the Version 2.0 documentation  to 
  93.       CSR, you'll want the file CSRUPDT.DOC.  If you are starting  from 
  94.       scratch you'll need CSRWHOLE.DOC.
  95.           The first step is to make sure you have a good ribbon in your 
  96.       printer,  enough  paper for an approx. 250 page document,  and  a 
  97.       MONO SPACED font.  (A proportionally spaced font on a dot  matrix 
  98.       or  laser  printer  makes for great  looking  text  and  horrible 
  99.       formatting.  Trust me....) 
  100.           6  LPI at 10 CPI....but then you know how to run  a  printer.  
  101.       Keep in mind that the document is already justified and  contains 
  102.       no tabs, only spaces.  And make sure you are lined up!  Watch  it 
  103.       for  a  few pages to make sure.  (There are no form  feeds,  just 
  104.       exactly  66  lines to a page.  Which means poor  alignment  won't 
  105.       correct itself and could mean an awful waste of printer,  ribbon, 
  106.       paper, time, etc.)
  107.           Ok,  I've probably over simplified it by now.  Use  the  same 
  108.       method as with the newsletter to dump it out.
  109.  
  110.           If  you use a 3 ring binder you'll be able to  easily  update 
  111.       your   documentation,  just  as  those  who  are   printing   out 
  112.       CSRUPDT.DOC  are now finding out.  (I keep the newsletters  there 
  113.       too.)
  114.  
  115.  
  116.       Some Things That Should be Mentioned.
  117.  
  118.           You'll  find that you can't backspace in the  [w]finptstred() 
  119.       function  unless  you are at the last character.  I  didn't  have 
  120.       time to fix it for this version.
  121.           The play() function will give a high beep instead of a  pause 
  122.       when  p (for pause) is specified.  The sound is a mix of my  code 
  123.       and  Paul Canniff's and I wasn't able to track the  problem  down 
  124.       yet.
  125.           For  some  reasons  absolutely  unknown to  me  I  can't  get 
  126.       programs  compiled with Turbo C's project-make to work  properly, 
  127.       despite  talking to Borland and hearing of a user who did get  it 
  128.       working.   If you can do it, please let me know how you  are  set 
  129.       up, and if you can't, watch The Pinelands BBS for a message  that 
  130.       says how.  (I'll put it up as soon as I find out.  Since I didn't 
  131.       think  this worthy of delaying the release I put it out with  the 
  132.       command line, and you shouldn't have trouble with that.)
  133.           The  global  color  and border attribute  variables  are  now 
  134.       available for use as externals, I didn't get around to explaining 
  135.       them completely anywhere.
  136.           The new menu functions have a lot of potential, but they  are 
  137.       currently  the  'first round.'  (They should have  a  description 
  138.       page in the 'related routines' area of the manual, but that's yet 
  139.       another thing I still need to do.)
  140.           08/11/87 - The problems with Microsoft C and the windows that 
  141.       delayed  the  'official'  release  have  been  fixed.   The  only 
  142.       remaining  problem  is  Microsoft C's  incompatibility  with  the 
  143.       interrupt driven sound, which works with Turbo C.  The fix,  when 
  144.       found, will be available on The Pinelands BBS.
  145.  
  146.           If  you  need input or menu routines that are a  little  more 
  147.       specialized  (and  thus more efficient and easier to  use)  I  am 
  148.       willing  to  do some custom work at a reasonable  rate.   I  have 
  149.       tried  to make them as versatile as possible, without leaving  to 
  150.       many holes, but they will never fit every need perfectly.  (Check 
  151.       out the [w]fbreakon() functions for the latest in 'versatility.')
  152.  
  153.  
  154.       Why You Should Register for C Spot Run.
  155.  
  156.           Why  should  you  register as a user of  C  Spot  Run?   Good 
  157.       question.
  158.           C  Spot  Run represents, as I've said many  times,  literally 
  159.       hundreds of hours of work.  The source code is approaching  8,000 
  160.       lines  (debugged and commented), the documentation is  about  250 
  161.       pages  (more  than  30,000  words!),  and  there  is  a   support 
  162.       newsletter, bulletin board, and updates.
  163.           I believe in Shareware, and I want to keep C Spot Run in  the 
  164.       Shareware  world.  I can't do that without support,  though.   My 
  165.       investment is of a lot of time, effort, and money.  (New compiler 
  166.       versions, better hardware, long distance phone calls, etc.)
  167.           If  you make supporting C Spot Run worth my while, I'll  make 
  168.       it worth your donation!
  169.  
  170.  
  171.       A Big Favor I Would Greatly Appreciate.
  172.  
  173.           During  the school year 1987-88 I will be a junior  in  high-
  174.       school.   I plan to start applying to different colleges  in  the 
  175.       near future, and I would really like some testimonial letters  as 
  176.       to my work on C Spot Run, etc.  If you use and like CSR, even  if 
  177.       you aren't a registered user, please write something for me.   If 
  178.       you  use CSR at work and could write on company  stationary,  all 
  179.       the better.
  180.           I would be extremely grateful for any assistance you can give 
  181.       me in this area.  Thank you.
  182.  
  183.  
  184.       Final Comments and Other Goodies.
  185.  
  186.           I've made all of my pleas and pledges so many times that  I'm 
  187.       sure there is no need to repeat them here.  Simply put, I can use 
  188.       any  of the following:  Money.  Source code.  Articles.   Example 
  189.       programs.  Testimonal letters.  Suggestions.
  190.           (Anything that lets me know you exist!)
  191.  
  192.           And  once again, feel free to call me if you want to  discuss 
  193.       something, or ask a question.
  194.  
  195.           - Bob Pritchett
  196.  
  197.